home *** CD-ROM | disk | FTP | other *** search
/ PC Media 6 / PC MEDIA CD06.iso / develon / modview / readme.txt next >
Text File  |  1995-01-01  |  9KB  |  165 lines
  1. Readme file for ThumbView File Browser Demonstration v. 1.0
  2. Package contents
  3. ================
  4. The files in this package are:
  5. TVMODD_I.PXP  - the IPAS browser application.
  6. TVMOD.MDX     - index file for sample meshes provided with 3D Studio.
  7. README.TXT    - this file.
  8.  
  9. Legal notice
  10. ============
  11. Animetix Technologies expressly disclaims any warranty for this software. 
  12. This software and any related documentation is supplied "as is" without 
  13. warranty of any kind, either express or implied, including, without 
  14. limitation, the implied warranties or merchantability or fitness for a 
  15. particular purpose. The entire risk arising out of use or performance of this 
  16. software remains with you. 
  17. This package may be copied and distributed free of charge provided that no 
  18. modifications are made to any part whatsoever.
  19.  
  20. Installation
  21. ============
  22. If you received this as a 'zip' file, unzip it to your hard disk first.
  23. Copy the file TVMODD_I.PXP into the directory that your 3D Studio setup 
  24. file specifies for PROCESS-PATH (the default path is the 'PROCESS' 
  25. subdirectory of your 3D Studio home directory).
  26. Copy the file TVMOD.MDX into the directory where the 3D Studio sample files
  27. are located (by defualt, this is the MESHES subdirectory of the 3D Studio
  28. home directory).
  29.  
  30. Running the ThumbView File Browser
  31. ======================================
  32. Start 3D Studio from the DOS command line. From the 3D Editor, select the 
  33. 'PXP Loader'  option from the 'Program' menu at the top of the screen. This 
  34. will bring up a list of all of the PXP IPAS routines in your process directory. 
  35. Select the TVMODD item, click on 'OK', and 3D Studio will load the 
  36. File Browser.
  37. Click on 'OK' to dismiss the initial text box.
  38. You should now see the main window for the File browser. Click on the 
  39. 'Browse' button in the lower left corner, and navigate to the directory 
  40. containing the sample mesh files that come with 3D Studio (BIRDSHOW.3DS is
  41. one such file). Click on 'OK' to return to the main browser dialog. The 
  42. browser will now load the thumbnails from the index file and you can scroll 
  43. through these. Single clicking the scroll arrows moves through the list by 
  44. one line and clicking on the scroll bar moves one 'page'. 
  45. Note that you can also drag the thumb to any point in the list of images. 
  46. Until you release the thumb, only the file name appears, allowing you to
  47. quickly find a file before you view its thumbnail.
  48. Note that in the demo version of this product, not all files have
  49. thumbnails available.
  50.  
  51. Viewing File Contents
  52. =====================
  53. If you select a file by clicking on its thumbnail, its thumbnail is 
  54. highlighted and its name is placed in the 'Selected File' window.
  55. If you click on 'View', or double click on the thumbnail, the file contents
  56. are loaded and the file viewer dialog is shown. Note that in the demo
  57. version of this product, you can only view file contents for those files 
  58. which have a thumbnail available.
  59. The file viewer dialog consists of a rendering window with associated
  60. controls to the left, and a contents list box to the right. An information
  61. panel is located at the bottom of the dialog box.
  62. When the file viewer dialog is initially launched, it displays all of the
  63. file's geometry in the rendering window. If you click in this window once
  64. and move the cursor, the viewpoint is rotated and the geometry re-rendered.
  65. Note that while the renderer is processing the model, the status indicator in
  66. the top border of the dialog turns red. Once the model has been re-rendered,
  67. this turns green.
  68. If you click again, while the status indicator is green, the mouse movements 
  69. no longer affect the viewpoint.
  70. Note the six buttons in the lower left border of the rendering window.
  71. These control your interaction with the rendering window, as follows:
  72. Button 1 (top)  - Press to activate, sets 'rotate viewpoint' mode.
  73. Button 2        - Press to activate, sets 'pan viewpoint' mode.
  74. Button 3        - Zooms viewpoint in by 20% each time it is pressed.
  75. Button 4        - Zooms viewpoint out by 20% each time it is pressed.
  76. Button 5        - Zooms viewpoint to fit window extents each time it is 
  77.                   pressed.
  78. Button 6        - Press to activate, auto-zooms viewpoint to fit extents.
  79.                   This feature is used with the 'selected' and 'highlighted' 
  80.                   object' modes described below.
  81.  
  82. Shading modes
  83. =============
  84. The renderer will display the geometry as Gouraud-, Flat-, or Wire-shaded,
  85. depending on the button selected at the top of the rendering window.
  86.  
  87. Object List
  88. ===========
  89. This list is displayed when the 'Objects' button above the list box is active.
  90. The list shows all of the objects in the file being viewed. If you click on
  91. an object, the object becomes the highlighted object and additional 
  92. information for this object is shown in the information panel at the bottom 
  93. of the dialog. 
  94. If you click on the 'H' button at the top left of the rendering window, the
  95. renderer redisplays only the highlighted object in the window. If the 
  96. AutoZoom button (see above) is active, the view is automatically adjusted to
  97. fit the entire object in the display window.
  98. If you double-click on an object in the list, its selection status is toggled.
  99. (a selected object has an asterisk to the left of its name in the list).
  100. By default, all objects are selected when the dialog is first launched. If you
  101. click on the 'S' button at the top left of the rendering window, the
  102. renderer redisplays only the currently selected objects in the window. If the
  103. AutoZoom button (see above) is active, the view is automatically adjusted to
  104. fit the entire object in the display window as the selection set of objects is
  105. changed.
  106. The 'All' and 'None' buttons below the list box select all objects and
  107. de-select all objects, respectively.
  108.  
  109. Viewing Material Information
  110. ============================
  111. If you click on the 'Materials' button at the top of the list box, a list of
  112. materials used by the file is displayed. If you click on an item in this list,
  113. additional information for the material is displayed in the information panel
  114. at the bottom of the dialog.
  115.  
  116. Viewing Map File Usage
  117. ======================
  118. If you click on the 'Maps' button at the top of the list box, a list of the
  119. maps referenced by all of the materials in the file is displayed. If you
  120. click on an item in this list, additional information for the map is displayed in the information panel
  121. at the bottom of the dialog. If you double-click on an item in this list,
  122. the Browser displays a windowed image of the map file, along with the file 
  123. name. If the image is smaller than a certain resolution, it is automatically
  124. resized to show it more clearly. In this case, a multiplier indicator appears in 
  125. the bottom border of the image window. Pressing any key or clicking the 
  126. mouse dismisses the image window and returns you to the browser window.
  127.  
  128. Note that when listing materials or maps, the last view renderered remains
  129. visible, but the viewpoint controls are disabled.
  130.  
  131. What the production version offers
  132. ==================================
  133. The production version of this product allows you to load or merge geometry
  134. from the file being viewed into your current 3D Studio drawing. Either the
  135. entire file, or the selected subset of that file can be loaded.
  136. You also get the other half of the mechanism for the browser: 
  137. The Index File Manager that allows you to create and maintain the index files
  138. for use with any set of mesh files, even if they reside on a CD-ROM. 
  139. The production version also allows you to view the contents of a file, even
  140. if no thumbnail is available for that file.
  141.  
  142. Compatibility
  143. =============
  144. This product has been fully tested with all versions of 3D Studio from 3.0 
  145. through 4.0 and supports 8-bit or 24-bit color displays. If you find a bug,
  146. please let us know. 
  147.  
  148. Other Products
  149. ==============
  150. Animetix Technologies is developing a range of IPAS applications. Other 
  151. products include:
  152.  
  153. ThumbView Material Browser -  an IPAS application that allows you to 
  154.                               preview the contents of 3D Studio material
  155.                               library files, using rendered thumbnails.
  156. Animetix MovieMaker     -     an IPAS application that lets you create 
  157.                               QuickTime movies of your animations directly
  158.                               from within 3D Studio.
  159.  
  160. For more information or to order these products, please call Animetix 
  161. Technologies at 514-767-2205.
  162.  
  163. 3D Studio is a registered trademark of Autodesk, Inc.
  164. QuickTime is a trade mark of Apple Computer, Inc.
  165.